This page last changed on Jan 02, 2007 by rosie@atlassian.com.

Page permissions allow you to control who can view or edit individual pages. Page permissions are set when editing a page from menus below the text-entry box.

A user can restrict the viewing or editing of a page either to themselves, or to a single group to which they belong. You can only restrict page permissions to a group that you are a member of, to prevent you from locking yourself out of a page. In the group picker, only groups you are a member of are listed.

In order to set or modify page permissions, a user needs to have 'Restrict Pages' permission in the space to which the page belongs, and permission to edit the page itself. So if a user is restricted from editing a page through page permissions, they are also restricted from changing the permissions themselves.

Page Security Rules

Users can only view page or space content for which they or a group they are in has 'View' permission. Pages that a user does not have 'View' access to are referred to inaccessible pages. Visit Inaccessible Page to see how Confluence deals with pages a user cannot view; anonymous users are directed to the login page while logged-in users are shown a permissions error page with a list of the groups with 'View' permission to the page. It is not possible to conceal the existence of pages, though you can restrict View access to page content. To keep the existence of a page or space secret, do not link to it from other sources.

Permissions and Child Pages

If a page has its 'View' permission restricted, that restriction will be inherited by all its children (and their children, and so on). If a 'View' permission is added to a page that has already inherited page permissions from its parent, users must satisfy both permissions in order to see the page.

'Edit' restrictions are not inherited.

Child Page Permissions Example

Consider the page 'Documents', with a child page 'Executive', which itself has a child page 'Payroll'. To begin with, anyone who can view the space to which these pages belong can see all three pages.

For security reasons, page permissions are set on the 'Executive' page, restricting it to the 'mycompany-management group'. At this point, anyone can still see the 'Documents' page, but you must be in the 'mycompany-management group' in order to view either 'Executive' or 'Payroll'.

Since 'Payroll' information is considered particularly private, the 'Payroll' page then has its page permissions set to only allow members of the 'mycompany-financial' group to view it. At this point, anyone can see the 'Documents' page, only members of 'mycompany-management' can see 'Executive', and only users who are members of both the 'mycompany-management' and 'mycompany-financial' groups can view 'Payroll'.

Note
Space administrators are responsible for the management of a space and its contents. As a result, page permissions affect them differently.
Space administrators can:
  • view all content on the site : If there are page permissions that restrict the viewing of a page to a single user, or to a group to which the space administrator doesn't belong, a space administrator can still view the page by removing the restriction.

  • edit all content on the page.

  • remove all restrictions from a page.

What would you like to do?

View Page Permissions
View Restricted Pages
Set Page Permissions

Confluence 2.2.x only permits restricting view or edit permission to one group. To apply your vote towards support for multiple groups, visit CONF-3701.

RELATED TOPICS

Working with Pages

Take me back to Confluence 2 Home

Document generated by Confluence on Feb 05, 2007 23:34